home *** CD-ROM | disk | FTP | other *** search
/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / FILE_CHG / STRPLINE.ZIP / STRPLINE.DOC < prev    next >
Encoding:
Text File  |  1993-09-12  |  4.6 KB  |  105 lines
  1.    
  2.                                   STRPLINE
  3.                                 Version 1.12
  4.            Copyright (c) Bob Swift, 1988-1993.  All Rights Reserved.
  5.                    Compiled with the Borland C++ compiler.
  6.    
  7.    This program is designed to read an input text file and strip out all
  8.    lines beginning with one of a series of patterns given in a configuration
  9.    file.  The configuration file is a simple text file with each match
  10.    pattern on a separate line.  Any line in the configuration file that
  11.    begins with a caret (^) is considered to be a comment line and will not
  12.    be processed.  The program creates a backup file called filename.BAK
  13.    prior to beginning the stripping operation.  This file is left upon
  14.    completion of the program.
  15.  
  16.    The format for using this program is as follows:
  17.  
  18.    
  19.         STRPLINE <filename> [configfile]
  20.    
  21.    where <filename>   is the name of the text file to be stripped
  22.          [configfile] is the file containing the patters to match
  23.                       default is STRPLINE.CFG in the current directory
  24.    
  25.    
  26.    The text file to be stripped must be in the current directory.  The
  27.    configuration may be specified with a full drive and path.  If the
  28.    configuration file is not specified, it will default to STRPLINE.CFG
  29.    in the current directory.  You are allowed a maximum of 256 search
  30.    patterns of 40 characters maximum.
  31.    
  32.    The program will display a VERY brief set of instructions if it is called
  33.    without any arguments or if it encounters an error.  The following is a
  34.    list of the error codes returned by the program:
  35.    
  36.                   0 - No errors.  Normal termination.
  37.                   1 - Missing or extra command line arguments.
  38.                   2 - Unable to open the input file.
  39.                   3 - Unable to open the output file.
  40.                   4 - Problem writing to output file.
  41.                   5 - Problem closing input file.
  42.                   6 - Problem closing output file.
  43.                   7 - Input file not in current directory.
  44.                   8 - Unable to open configuration file.
  45.                   9 - Problem closing configuration file.
  46.                  10 - No patterns in configuration file to strip.
  47.                  11 - Unable to open backup file.
  48.    
  49.    When an error is encountered, the program will exit immediately and will
  50.    attempt to properly close all files.
  51.    
  52.    Although I have chosen to retain all rights to this program, you are free
  53.    to use it under the following conditions:
  54.    
  55.             - You realize that there is NO Warrantee of any sort.
  56.               It was tested pretty thoroughly here before release
  57.               but who knows what bugs may be lurking within.
  58.             
  59.             - You will not modify the code and release a new version
  60.               of the program.  I welcome suggestions for improvement
  61.               (especially when accompanied by code) but I make no
  62.               guarantee of future releases.
  63.             
  64.             - If you find the program useful, I ask that you do 
  65.               something to brighten somebody else's day.  Just 
  66.               exactly what, I will leave up to you.
  67.  
  68.    
  69.    You may freely distribute this program provided that you distribute only 
  70.    the complete archive which includes the STRPLINE.EXE, STRPLINE.C,
  71.    STRPLINE.CFG and STRPLINE.DOC.  In addition, You MUST NOT charge for the
  72.    program nor can you charge a copy fee over $4.00 (including the price of
  73.    the diskette).  
  74.  
  75.    
  76.                                                    Bob Swift (1:342/5)
  77.  
  78.  
  79.    Revision History
  80.    ----------------
  81.  
  82.    1.01 - 88/07/01 - Original release version.
  83.  
  84.    1.01 - 88/07/03 - Modified to output instructions, line counts, and
  85.                      error messages to the console only (no redirection).
  86.  
  87.    1.02 - 88/07/12 - Changed output method to allow redirection and to
  88.                      avoid problem of "bleed through" when using multi-
  89.                      tasking software like DoubleDOS.  Increased maximum
  90.                      number of search lines from 10 to 20.
  91.  
  92.    1.03 - 88/07/13 - Modified to display the search patterns used.
  93.  
  94.    1.10 - 89/01/05 - Modified to allow stripping of blank lines.  This is
  95.                      accomplished by entering a blank line (no spaces) in
  96.                      the configuration file.  In previous versions, a blank
  97.                      line was ignored.  Updated to Turbo C 2.00.
  98.  
  99.    1.11 - 90/01/22 - Number of search patterns increased to 256.  Upgraded
  100.                      to Turbo C++ 1.00.
  101.  
  102.    1.12 - 93/09/12 - Updated Fidonet address in documentation.
  103.  
  104.  
  105.